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I. Glossary 


Machine instruction - Binary byte(s) that execute to perform a defined 
computer function. 

Assembly (source) code - Symbolic labels, opcodes, and operands that are 
ordered in succession to define a logical procedure which can be 
assembled to produce executable machine instructions. 

Opcodes - Defined symbols that assemble directly as 1 to 3 bytes of 
machine instruction. The symbols are meaningful descriptors of the 
^achine function to be performed during program execution. 

Label - A user defined symbol that corresponds to the storage address of 
the following opcode. Labels, are used to define points for transfer of 
program execution which normally proceeds in a sequential manner. 

i 

Operands - Symbolic references to registers, labels or constants that 
are used to completely define the function specified by the opcode. 

Pseudo-opcodes - Mnemonics that direct the assembly of the source code. 
They can allocate memory, define constants or affect control of the 
assembly procedure. 

Execution storage - The physical memory space where an assembled program 
can execute. Absolute assembly generates machine instructions that will 
only execute correctly in memory space that was defined during assembly 
(defined by ORG pseudo op). 

Program storage - The physical memory where program machine code is 
stored during assembly. The program will not necessarily execute 
correctly at this location unless assembly defined the program storage 
to be the same as execution storage (no ORR psuedo op given). 

Debug - The process of testing a program to remove logic errors (bugs) 
by analyzing the program's execution (performance). 

Patch - Correct a program by changing machine instructions during 
debugging. 


Symbols used in Manual 


<CR> - Type a carriage return. 

<LF> - Type a line feed. 

<Control z> - Type a Control Z not the individual characters. 
<Escape> - Type an escape (TTY key usually has ESC on it). 
<Tab> - Type a tab (Control I). 

Anything enclosed in square brackets (i.e. [ ] ) is optional. 

A Q following a number indicates the number is octal. 
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ri. System Monitor 


The system monitor has been designed to load and execute 
absolute programs, have a flexible I/O system for supporting all MITS 
peripherals, allow handlers for non-standard peripherals to be added, 
and have limited debugging capability. 

There are three tables within the monitor that make this 
flexibility possible. The names of all programs that have been read in 
are stored in the program name table (PTL). All open I/O symbolic 
names, flags, and other information are contained in the I/O table. The 
hardware table contains the addresses of the device handlers. 


Hardware Table 


OloH OH' 


This table has room for 5 entries, 4 of which are defined for 
standard MITS I/O devices. The four default device names and uses are: 
TY - Console terminal 7 ^'- 
AC - Audio cassette 
EB - Edit buffer read » J 
TR - MITS high speed paper tape reader ^ ^ 

The exact structure of this table and instructions on how to modify it 
are given in Appendix D._ 


I/O Table 


The I/O table 

has room 

for 

7 symbolic 

device 

names 

to 

be 

open 

simultanEously. 

The five 

names used 

by 

PKG 

II 

programs 

are 

automatically open 

, leaving 

room 

for 2 names 

to 

be 

set 

up 

for 

user 


programs if needed. 


TTY - Monitor, Editor and Assembler command I/O device name 9^ 
Open for echoing, tabbing, and ASCII mode 
LST - Editor, Debug, and Assembler list on LST 
Open for tabbing and ASCII mode. 

FIL - file I/O for Editor and Assembler 9 iT 
Open for echoing and ASCII mode. 

ABS - program loading and file searching 6 ^ 

No options 

ALT - used by Editor’s alter command A A 
Open for tabbing 
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f ' 

The block diagram oL the I/O table shows all pointers ( rom thf* 
symbolic device names going to the “TY" entry of the Hardware tal)le. 
Tills is because all are open to "TY" when the monitor lirst comes up and 
can be changed at any time by giving an OPN command. 

In order to support a non-standard I/O device, a driver would need to be 
written and the address of it patched into the hardware table as 
explained in appendix D- The device could then be used by all PKG II as 
well as user programs. 


Monitor Command Format 
1. Execute a program 

The Monitor signals that it is ready for a command by 
printing 2 blanks and a question mark. A program is 
executed by typing its 3 character name followed by a 
carriage return. If the program has already been 
loaded, it will start execution immediately. If it 
hasn't, it will be searched for and loaded from 
symbolic device ABS. When the program finishes loading 
it will automatically start executing. 

Example: 

If you want to load the Editor from your TTY type: 

?OPN ABS,TY<CR> 

?EDT<CR> 

The OPN command would only be needed if ABS was not 
open to the TY. 

To load the Editor from the ACR make sure the last OPN 
ABS command was as follows: 

?OPN ABS,AC<CR> 

2. Execution time options 

User programs can be passed execution options by the 
monitor if the options are enclosed in parentheses. 
?EDT(R)<CR> 

When the program requested is branched to the D&E 
register pair contain the address of the first 
character following the monitor command. In the above 
example D&E would point at the open parenthesis. The 
B&C register pair contains the address of the monitor 
status word, which contains the length of the command 
line. In the above example the status word contains 
the number 6. 
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3. File searching 

By typing a file name followed by a comma and a type 
designator, the monitor will search for the file on the 
device ABS is open to, and return after the file is 
skipped. 

S - ASCII file 
A - Absolute file 

The main use of this command is to search for the last 
file on an audio cassette in order to write out a new 
one. All files on the the cassette should be of the 
same type as the file you are searching for. 

?OPN ABS,AC<CR> 

?AM2,A<CR> 

This example would search for the absolute file "AM2'' 
on the ACR. After finding the file, it would be 
skipped and control returned to the monitor. 
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Utility programs 


The monitor includes 9 utility programs: 

CLR - Deletes a program name from the PTL. 

OPN - Opens a symbolic device name to a physical device. 

CLS - Removes a symbolic device name from the I/O table. 

DEP - Used to change contents of memory locations. 

EXM - Used to print in octal the contents of memory. 

JMP - Causes the machine to start executing at any location. 

DMP - Dumps out memory in the checksum format. 

NUL - Sets the number of hulls to output after a <CR>. 

CNS - Console command 

All numbers typed as parameters to these programs should be octal. 

1. OPN 

This program is used to assign different physical 
devices to a symbolic name making programs device 
independent. 

?OPN ABS,TY<CR> 

This command opens the symbolic name "ABS" to the 
Teletype. In this type of OPN the mode default would 
be assumed. These are: 

No echo - Don't echo input. 

Absolute - All 8 bits of every read are 
transmitted. 

Tabs - A Control I is output. 

The options are: 

E - Echo all input on TTY 

A - ASCII mode, high order bit of characters 
masked to 0 and the line format described in 
Appendix F is recognized. Even parity is 
generated on output. 

T - Tab control. Spaces are printed to force 
cursor into a column that is an even multiple 
of 8 from the left margin. The tab character 
is Control I (IIQ). 

The options are specified at the end of the command and 
are separated by commas. The order in which they occur 
is irrelevent. If the symbolic name is already open 
when another command to open it is given, the symbolic 
name is reopened according to the new command. 


2. CLS 


Closing a symbolic name removes the name from the I/O 
table making the name unavailable until it is reopened. 
?CLS ABS<CR> 

In this example "ABS" is now closed meaning that no 
program should be executed that reads or writes on 
"ABS" . If an I/O operation is attempted the program 
will abort, causing the monitor to print an error 
message. 




Page 8 


3. CLR 


This command deletes a program name from the PTL. 
?CLR EDT<CR> 

After giving the above command 
?EDT<CR> 

will cause the monitor to try to reload the EDITOR. 


4. DEP 


This command lets the programmer modify memory 
locations directly from the monitor. The format is; 
?DEP ADDRESS<CR> 

All octal numbers typed after this command will be 
deposited starting at the address given. Typing a 
Control Z returns control to the Monitor. 

Example; 

?DEP 5000<CR> 

25<CR> 

50<CR> 

175<CR> 

<CONTROL Z> 

7 

Location 5000 would now contain ah octal 25, 5001 a 50 
and 5002 a 175. 

5. EXM 

The format of the examine command is as follows; 

?EXM ADDRl[,ADDR2]<CR> 

The contents of memory locations are dumped out in 
octal starting at the location specified by ADDRl, 
through ADDR2. If ADDR2 is not given or is = ADDRl 
only the location at ADDRl is printed. 

Example; 

?EXM 100<CR> 

303 

?EXM 100,101<CR> 

303 

153 

?EXM 100,0<CR> 

303 

7 
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6. JMP 

The Eormat of the jump command is as follows: 

?JMP ADDRESS<CR> 

The jump command causes the machine to start executing 
at the address given in the command. All registers are 
loaded from the save area prior to jumping. 

Caution: Make sure SP register will be loaded with a 

valid memory address that can be used for a stack. For 
a further explanation of the save area see section 8 of 
the Program Monitor Calls. 

7. DMP 

The format of the dump command is as follows: 

?DMP [NAME,]ADDR1,ADDR2[,START ADDRESS]<CR> 

The name field of the command should contain the 3 
character name of the program followed by any comments. 
The only restriction is this field should not contain a 
comma. ADDRl is the address of the first location to 
be dumped and ADDR2 is the address of the last to be 
dumped. If a start address is not specified the 
monitor will automatically be returned to when the tape 
is loaded. 

Example: 

You want to dump a program located at 5100Q - 53520f 
name it TST, put in a comment indicating it is the 
first draft of the program and have it start executing 
at location 5100Q. 

?DMP TST REVISION 0,5100,5352,5100<CR> 

8. NUL 

The format of the NUL command is as follows: 

?NUL NUMBER<CR> 

this command causes the number of nulls specified to be 
output after every carriage return written in the ASCII 
mode. It is advisable to use this command before 
saving long program files on cassette or paper tape, 
thus insuring no characters will be missed during 
assembly. 

Example: 

Before saving a program on audio cassette, give the 
following command: 

?NUL 4<CR> 

9. CNS 


The console command is used to switch between terminals 
connected to your Altair.- Before giving a console 
command, set the sense switches to indicate the type of 
I/O board to switch to ( See Appendix E ). If the I/O 
port address is not the same as the default listed in 
the terminal options chart, flip sense switch 8 up and 

4-ho T/O n+- 1or«r>4-Tr\r> C'70r^ 
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Program Monitor Calls 

The following section decribes how a user written program 

implements the features of the Monitor, thus freeing the programmer of 

the need to write I/O handlers for each program . 

Before any call to the monitor is performed the B&C register pair 
must contain the address of a monitor control block. A monitor control 

block is used to specify the operation to be performed, symbolic device 

to use, etc. The monitor is called by executing a CALL 10. All 
registers are restored before returning to the calling program, and the 
monitor control block is left unchanged. The example program at the end 
of the assembler programming section uses monitor I/O. 

1. READ 

LXI B,RDPKT ;L0AD B&C WITH ADDRESS OF THE 

;MONITOR CONTROL BLOCK 
CALL 10 ;CALL THE MONITOR 

- DONT PUT MONITOR CONTROL BLOCK NEXT IN YOUR PROGRAM - 


RDPKT: 

DB 

20Q 

;OPERATION CODE FOR READ 


DB 

‘'SDN" 

;SYMBOLIC DEVICE NAME 


DW 

INBUF 

;ADDRESS OF THE BEGINNING OF 
;THE INPUT BUFFER 


DW 

80 

;MAXIMUM NUMBER OF CHARACTERS 
;T0 BE READ IN 


DW 

STAT 

;ADDRESS OF STATUS WORD 


DW 

END 

;END OF FILE RETURN ADDRESS 

After 

the read 

has been 

completed, the status word 

contains the number of 

bytes_ read in. 


2. WRITE 


WRPKT: 


LXI 

B,WRPKT 

?L0AD B&C WITH ADDRESS OF 
;MONITOR CONTROL BLOCK 

THE 

CALL 

10 

;CALL THE MONITOR 


DB 

22Q 

;OPERATION CODE FOR WRITE 


DB 

•’SDN" 

ySYMBOLIC DEVICE NAME 


DW 

OUTBUF 

?ADDRESS OF THE OUTPUT BUFFER 

DW 

80 

yNUMBER OF BYTES TO WRITE 

OUT 

DW 

STAT 

;ADDRESS OF STATUS WORD 



When the monitor returns, 
number of bytes output. 


the status word contains the 



I 



3. OPEN 


LXI 

B,OPNPKT 

yLOAD B&C WITH ADDRESS OF T 
;MONITOR CONTROL BLOCK 

CALL 

10 

yCALL THE MONITOR 

OPNPKT: DB 

63Q 

;OPERATION CODE FOR OPEN 

DB 

"SDN" 

;SYMBOLIC DEVICE NAMED TO BE 
yOPENED 

DB 

.. 

yDEVICE TO BE OPENED TO 

DB 

XXX 

yHARDWARE CONTROL BYTE 


The hardware control byte specifies echo control and 
and ASCII or absolute read mode. 

Bit 1-1 for ASCII read mode, 0 for absolute 

Bit 2-1 for input echo, 0 for no echo 

Bit 3-1 for tabs to be expanded, 0 for no expansion 
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CLOSE 


LXI 

B,CLSPKT 

;LOAD B&C WITH THE ADDRESS OF 
THE MONITOR CONTROL BLOCK 


CALL 

10 

CALL THE MONITOR 

CLSPKT: 

DB 

62Q 

OPERATION CODE FOR CLOSE 


DB 

•'SDN“ 

SYMBOLIC NAME TO BE CLOSED 

ERROR 


LXI 

B,ERRPKT 

;LOAD B&C WITH ADDRESS OF THE 
MONITOR CONTROL BLOCK 


CALL 

10 

CALL THE MONITOR 

ERRPKT: 

DB 

60Q 

OPERATION CODE FOR ERROR 
HANDLING ROUTINE 


DB 

"X" 

ONE CHARACTER TO BE OUTPUT AS 
ERROR MESSAGE 


The character specified followed by a # sign will be 
echoed by the monitor instead of the next 2 characters 
that would normally be echoed. 


6. PASS PROGRAM 


PASPKT: 


NAME 


LXI 

B,PASPKT 

CALL 

10 

DB 

61Q 

DB 

••PRG” 

DW 

PRG 


;LOAD B&C WITH ADDRESS OF THE 
MONITOR CONTROL BLOCK 
CALL THE MONITOR 
OPERATION CODE FOR PASS NAME 
NAME ROUTINE 
3 CHARACTER PROGRAM NAME 
START ADDRESS OF PROGRAM 


The 5 bytes of name and address are copied into the PTL 
and the program jumped to. 


7. 


FIND ASCII FILE 


FFPKT: 


LXI 

B,FFPKT 

CALL 

10 

DB 

65Q 

DB 

"SDN" 

DB 

"FIL" 


LOAD B&C WITH ADDRESS OF THE 
MONITOR CONTROL BLOCK 
CALL THE MONITOR 
OPERATION CODE FOR A FIND FILE 
SYMBOLIC DEVICE TO SEARCH ON 
FILE TO BE SEARCHED FOR 


This call causes the monitor to search for the named 


program on the physical device that the symbolic device 
name is open to and return to the calling program as 
soon as the named program is found. 


8. Returning to the Monitor 

When a program has finished its job and wishes to 
return to the Monitor, a JMP MON will be needed. All 
registers are saved in the register save area and the 
stack pointer is reloaded to delete anything left on 
the stack. The address of the monitor is on the stack 
when a program is executed by the monitor, so if your 
program has left nothing on the stack, a return 
instruction can be used to return to the monitor. 
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The symbols MON and 10 are permanent equates within the 
assembler. The actual locations are - MON-100Q, 
IO-103Q 

When a program returns to the monitor either by jumping 
to location 100Q, examining location 100Q and pressing 
RUN , or by typing a Control C all registers are stored 
in the register save area. The order in which they are 
saved is given below. 


571 

FLAGS 


572 

A - 

REGISTER 


573 

C - 

REGISTER 


574 

B - 

REGISTER 


575 

E - 

REGISTER 


576 

D - 

REGISTER 


577 

L - 

REGISTER 


600 

H - 

REGISTER 


601 

SP 

- REGISTER 

(LOW BYTE) 

602 

SP 

- REGISTER 

(HIGH BYTE) 

603 

PC 

- REGISTER 

(LOW BYTE) 

604 

PC 

- REGISTER 

(HIGH BYTE) 


If a program is waiting for input from the TY and a 
Control C is typed, the PC stored in the save area is 
the address of the instruction following the monitor 
call. 


Note - 30 octal bytes of stack have been allocated for 
user program use. If more stack space is needed, a LXI 
SP instruction will be needed in your program to set up 
its own stack. 
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III. Assembler Operation 
Introduction 


Typical assemblers process source code by reading the same source 
code 2 , 3 , or 4 times to produce a load tape that must then be loaded 
before executing the program. An assembler that requires that type of 
procedure is extremely cumbersome for users with paper tape or cassette 
magnetic tape input. Off-line storage is always required for assemblies 
of this type. Further, high speed storage is desireable due to the 
efxtensive I/O required during processing. 

The MITS loading assembler was designed to process source code 
directly into memory for immediate execution or to produce an absolute 
load tape for later execution in the space occupied by the assembler. 
The source code is processed only once, thereby producing executable 
code in a minimum amount of time. Significant improvement in program 
development time is achieved, especially for users with program input 
rates under 100 characters/second. Furthermore, the assembler is still 
resident in memory with the user program, so it can be used to patch 
program errors during debugging. Since the patches can be entered in 
symbolic source code and labels can still be assigned to correct 
execution sequences, fewer errors are introduced in the debug process. 
Thus complete programs can be input and developed with input from only 
^n ASCII keyboard and a minimal amount of memory (the Monitor and 
sembler require approximately 5k bytes). 

The loading assembler allows two types of assembly: 1) direct 
assembly, which loads programs into any unused memory space and 2) 
indirect assembly, which generates a load tape for programs that will 
reside in memory space that is being used during the assembling process. 
Program modules(parts) can be developed and debugged separately, then 
assembled with all source errors corrected for off-line loading to other 
program space. The modules can be linked during assembly using the 
preserved symbols from previous assemblies or by defining names for 
referenced locations in other modules. Source programs are input from a 
Monitor-defined device called "tty" and all selected output is to device 
"LST". Input can be selected from a source file that was created by the 
Editor. The files can be assembled in any sequence selected. 


t 


> 


J 
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Assembler Options 


The assembler was designed as a module of the MITS operating system 
to be loaded by the system monitor. The assembler is loaded from the 
device ABS is open to when the assembler is executed for the first time. 
The following execution options are possible whenever starting the 
assembler. 


I 


inhere: 


ASM(A,S,P) 

tPh JO 

P=Preserve symbols entered during previous assembly(s). 
used for symbolic patches and program additions 


S=Symbol table listing wanted at end. All defined 
names and label symbols with corresponding program 
addresses and the next program address($) are output 

A=Absolute tape dump wanted at end. Binary output for 
Monitor loading is output to "ABS" 

All output begins at the first storage address that was defined by 
the first ORG{ or ORR when used ) and continues to the current address, 
program addresses are used for the absolute tape dump and defined symbol 
listings. 

Warning*** If assembly is begun without the P option the symbol table is 
cleared and is not recoverable. 


Assembler Pseudo Op's 
FILE pseudo Op f 

The file input pseudo op forces source input to be read from 
symbolic device "FIL". If a file name is given as an operand, a file 
with that header is searched for before processing any input. The 
source file must end with a Control Z or EOA pseudo op so that control 
is restored to the Monitor at the end of file. Assembly can be 
continued by entering the Assembler with the P-option. 

Example: 

FILE TWO ;INPUT FILE "TWO" FROM CASSETTE 

END Pseudo Op 

All of the entry options in the group(S,A) are performed each time 
an END pseudo op is encountered. The END statement will also produce a 
listing of all undefined symbol names with program storage locations 
that reference the symbol. If the A-option was selected, the first 3 
letters of the operand define the program name when loaded by the 
Monitor. Up to 77 characters following can be used to document the 
program(Revision, Date, etc.) 



imple: 


PRG 
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END 


EGA Pseudo Op 


IF THE A OPTION WAS SPECIFIED 
THE PROGRAM WOULD BE DUMPED 
WITH NAME PRG 


The Assembler will return control to the Monitor when an End Of 
Assembly (EOA) pseudo op is encountered. The Monitor prints a prompt to 
indicate it is in control. 


Memory Allocation 

The user must understand the way that memory is used during the 
assembly process to avoid errors and to use available memory in an 
efficient way. The diagram in Appendix B illustrates the relative 
storage used during assembly. 

The user must estimate the symbol space needed for each assembly 
before defining the first storage location. It should be apparent that 
shorter symbols and fewer labels or names will increase the space 

available for user program storage. A rule of thumb for estimating 
symbol table space is to reserve 1 byte of symbol table space for each 
statement in the program. 

ORG Pseudo Op 

This pseudo op is required to be the first statement of all 
programs. It defines the memory your program will run in and and where 
the Assembler should store it while the Assembler is running. 

ORR pseudo Op 

If the address of the start of the program given by the ORG 

statement does not allow enough space for the symbol table, an ORR 
statement will be needed to set the address at which the program should 
be stored during assembly. Since the symbol table is built from the end 

of the Assembler to this address, its maximum size can be set with this 

pseudo op. 

Example: 

?ASM<CR> 


*ASM* 


ORG 

ORR 


5100Q ;WANT PROG TO LOAD AT 5100Q 
17000Q ;SINCE ASSEMBLER IS AT 5100Q 
;A PLACE TO SAVE THE PROGRAM 
;DURING ASSEMBLY MUST BE SET UP 
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DS Pseudo Op 

Storage is allocated with the ds pseudo op. The contents of the ‘ J 

storage space is not changed and should normally be preset during 
execution prior to use. The operand must be a defined symbol(EQU or SET 
to a constant) or a constant value. A label symbol defines an address 
which should not generally be used for a storage operand. A DS psuedo 
op is generally preceded by a label used to reference the storage 
allocated during program execution. 

Example: 

LABEL; DS 20 ;THIS RESERVES 20 BYTES OF MEMORY 

DW Pseudo Op / 

An address word or byte quantity is preset (assigned during 
assembly) by using the DW pseudo op. The 2-byte value is stored with 
the least significant byte in the first memory address and the most 
significant byte in the next higher memory location. This feature is 
the same as all 2-byte operands for machine opcodes(i.e. JMP, LXI, 
etc). This arrangement is convenient because it allows byte references 
to the least significant byte using the same label as a word reference. 

Multiple operands are allowed and must be separated with a space or 
comma. 

Example; 

LABEL; DW LOG I THIS STORES THE 2 BYTE ADDRESS OF LOG 

DB pseudo Op / 

All byte constants are defined by using the DB pseudo op Multiple ' ' 

operands can be used. All operands define one byte of storage except 
string or literal constants which are stored as one ASGII character per 
byte. Each operand must be separated by a space or comma. 

Example; 

DB 0 ;STORES THE GONSTANT 0 IN 1 LOCATION 

DB "THIS IS A STRING CONSTANT" 

?THE ABOVE STRING WOULD BE STORED 1 CHARACTER 
;T0 A BYTE, SO IT WOULD TAKE 25 MEMORY 
;LOCATIONS 

DC Pseudo Op 

The define character pseudo op is used to define literal constants 
of determinable length. All characters except the last have their high 
order bit masked to zero, but the last character has it set to one. The 
last character can then be found by searching for a character with its 
high order bit on. 

Example; 



DC 


"AB 


STORES THE CHARACTERS IN 2 CONSECUTIVE 
MEMORY LOCATIONS WITH THE HIGH ORDER BIT OF 
THE LAST CHARACTER TURNED ON. 
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BQU Pseudo Op 


A symbol can be defined prior to use by assigning it a value equal 
to a specified constant or another label that has already been defined. 
A symbolic name(not a label) is defined by using the EQU pseudo op and a 
defined operand. The EQU pseudo op cannot be used to change the value 
assigned to a name. Refer to the SET pseudo op. 

Example: 

ONE EQU 1 ;THIS SETS THE VALUE OF ONE = TO 1 

MVI A,ONE ;THIS WOULD NOW BE THE SAME 

;AS MVI A,1 

SET Pseudo Op 

A name can be changed or reassigned by using the SET pseudo op in 
the same manner as the EQU pseudo op. THE SET PSEUDO OP CAN ALSO BE 
USED TO ASSIGN A VALUE THE FIRST TIME A NAME IS DEFINED. 

BEG PSEUDO OP 


THE OPERAND OF THE BEG PSEUDO OP IN A PROGRAM SETS THE BEGIN 
EXECUTION ADDRESS, OUTPUT BY THE ASSEMBLER DURING AN ABSOLUTE DUMP. IF 
THE BEG PSEUDO OP IS NOT FOUND, A START ADDRESS OF 100Q WILL BE ASSUMED, 
CAUSING A RETURN TO THE MONITOR AFTER THE PROGRAM LOADS. 

RUN PSEUDO OP 

THE OPERAND OF A RUN command should be a 3 character program name, 
it will be entered along with the most recent BEG address into the PTL 
and the BEG address branched to. once a RUN command has been given, the 
program can be reexecuted from the monitor. Example: 

RUN NEW PROGRAM OUTPUT> ?NEW CR> 


IV. Assembler Programming 


Assembly programs include symbolic names,constants, opcodes and 
comments in sequential statements that are converted by the Assembler to 
produce executable machine instructions. Each line or program statement 
of source code must follow certain rules that govern the acceptable 
structure of the program. If they are not observed, assembly or 
execution errors will occur. This section will define the form that is 
acceptable to the MITS Loading Assembler. 

Character Set 

The entire 128-character ASCII character set is acceptable but all 
opcodes are defined in capital letters. Any combination of characters 
beginning with a non-numeric character can be used for statement labels 
symbolic names. The maximum length for these symbols is 255 
aracters, but to minimize symbol table length, they should be kept as 
short as possible. 
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Constants 

Constants can be used whenever an operand is required. All 
constants begin with a numeric character and can end with an alphabetic 
character that defines the radix of conversion. If the last character 
is numeric, the conversion defaults to decimal. Legal conversions are 
as follows: 

12340 OCTAL 

5678Q OCTAL(8 CONVERTS AS 0) 

12345D DECIMAL 

0ABCD DECIMAL(A CONVERTS AS 1,ETC.) 

057EFH HEXIDECIMAL 

NOTE: Values are first masked leaving only the significant binary 

quantities, thus alphabetic conversions are legal. Byte values are set 
equal to the converted value using modulus 256 arithmetic. Similarly, 
overflow of 16-bit constants(words) during conversion is ignored. 

String or literal constants are defined by enclosing all characters 
in symbols. The " symbol cannot be defined in a string constant. 
Example: 

DB "THIS IS A MESSAGE" ;THIS IS A CONVENIENT 

;WAY TO STORE A MESSAGE FOR OUTPUT 
;DURING PROGRAM EXECUTION 

WARNING****** Only one character should be used if a single byte operand 
is required{i.e. MVI A,"ABC" will store 4 bytes). 

Statement Structure 


The assembly source statements may include any of the following in 
the order given; 

1. Symbolic label of any length terminated by a colon{;). The 
symbol can include any ASCII character except delimiters(Space, TAB, or 
Comma) in any combination including instruction opcodes. The following 
symbols are predefined values. 

$=current location counter 
The following are only valid byte(not word)values. 
B,C,D,E,H,L,M,A=0,1,2,3,4,5,6,7 respectively 
SP and PSW==6 


2. A name is the same as a label except that a terminating colon 
is not used. A name is used in place of a label and remains undefined 
until a defining pseudo opcode is encountered (i.e. Equ, SET). 
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3. Opcode(s) or pseudo opcode(s) with required operands. All 
opcodes that are defined in the Altair 8800 Operators Manual and All 
pseudo-op*s defined in section III are acceptable to the Assembler. 

4. Comments are used to document the source code but are not 
required by any statement. Comments begin with a semi-colon{;) which 
terminates assembly of all following ASCII characters on the , line. 
Lines that begin with a semi-colon contain only comments. 


Statement Options 

All register pair instruction operands can reference either of the 
two 8-bit registers in the pair. 

Thus— 

POP A is the same as POP PSW 

LXI L is the same as LXI H 

OCX C is the same as DCX B 


Multiple instructions can appear on the same line of source code. 
This feature can be used to minimize the number of characters on a 
source tape and in some cases will improve the program readability. 

MOV B,H MOV C,L 
RAR f RAR 


The delimiters SPACE, TAB, or COMMA can be used anywhere in the 
line to improve readability. 


Statement Formats 


**************************************************************** 

* * 


*[ LABEL: ] MNEMONIC [ OPERAND FIELD ] [ ;COMMENTS ]* 

* (THIS FORMAT IS OSED FOR ALL STATEMENTS EXCEPT EQU AND SET ) * 

* * 

*NAME MNEMONIC OPERAND FIELD [ ;COMMENTS ]* 

* ( THIS FORMAT IS USED FOR EQU AND SET STATEMENTS ) * 

* * 

**************************************************************** 


programming Tricks 

The choice of opcode(s) used to achieve a specific result is based 
on the generally accepted criteria that a program should use a minimal 
amount of space and should execute as rapidly as possible. The 
fallowing practices are recommended: 

1. Avoid the instruction sequence 
CALL Subroutine 


n T?rn 
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in favor of 

JMp Subroutine 

The JMP statement will return to the same place without need for 
the RET thus saving one byte of program storage. 


2. Avoid CPI 0 

which requires two bytes of storage 

in favor of 
ORA A 

which requires one byte of storage 
All flag bits are affected in the same manner without changing 
the contents of the A-register. 


3. Avoid PUSH B,POP H 

or similar register contents transfer 

in favor of 
MOV H,B MOV L,C 



which executes 

in less time. 



4. 

If a series of MVI 2-byte 

instructions 

is used 

followed by a 

j ump to 

the same address, use LXI B (db 1) to 

replace 

the jumps, thus 

saving two bytes. 




For 

Example: 




AERR: 

MVI A, "A*' 

AERR: 

MVI 

A, “A" 


DB 1 


JMP ERR 


BERR: 

MVI A,"B" 

BERR: 

MVI 

A,“B'‘ 


DB 1 


JMP ERR 



etc. 


ERR: 

A JMP to any MVI to set the "ERR" code will load the A-reg with the 
character to be output and will skip over the rest by executing the DB 1 
as LXI B,XXXX where XXXX is the two-byte MVI instruction. The contents 
of B&C will change. Other register pairs can be used similarly. 



Page 21 


/ Example Program 

A sample program and assembly are given to illustrate the .operation 
of the assembler and use of the monitor calls for output. 

The sample program will dump out any section of memory in octal as 
shown later in the example. This type of memory dump can be very useful 
in debugging programs. In order to use this program, change the 
addresses at locations FIRST and LAST to the address of the first and 
last memory location you want dumped. 


?ASM(A,S) 


*ASM* 


ORG 


DUMP: 

NEWLN: 



LHLD 

XCHG 

LXI 

PUSH 

LHLD 

MOV 

SUB 

MOV 

SBB 

POP 

JC 

MOV 

RAL 

MV I 

RAL 

ORI 

MOV 

INX 

MOV 

RAR 

RAR 

RAR 

RAR 

AN I 

ORI 

MOV 

INX 

MOV 

RAR 

AN I 

ORI 

MOV 

INX 

MOV 

RAR 

MOV 


20000Q 

FIRST 

H,BUF 

H 

LAST 

A,L 

E 

A,H 

D 

H 

MON 

A,D 

A,0 

60Q 

M,A 

H 

A,D 


;SET LOCATION COUNTER 

;WILL NEED TO BE CHANGED IF ONLY 8K MACHINE 
;GET ADDRESS OF FIRST BYTE TO BE DUMPED 
;PUT ADDRESS IN D&E 
;GET ADDDRESS OF OUTPUT BUFFER 
;SAVE ADDRESS 

;LOAD ADDRESS OF LAST BYTE TO BE DUMPED 
; SUBTRACT LOW ORDER BYTES 

; SUBTRACT HIGH ORDER BYTE 

; RESTORE H&L 

;JUMPS OUT IF NO MORE BYTES TO BE DUMPED 
; START CONVERSION OF ADDRESS TO ASCII 
; ROTATE HIGH BIT INTO C 

;ZERO OUT REST OF A BUT DONT CHANGE FLAGS 

; ROTATE HIGH BIT INTO LOW ORDER POSITION 

;OR IN ASCII 0 

; STORE IN OUTPUT BUFFER 

; INCREMENT BUFFER POINTER 

;PICK UP HIGH ORDER BITE AGAIN 

; ROTATE BITS 4,5,6 INTO LOW ORDER POSITIONS 


7 

60Q 

M,A 

H 

A,D 


60Q 

M,A 

H 

A,D 
A, E 

T TV c m O 


MASK OFF ALL BITS EXCEPT LOW THREE 

OR IN ASCII 0 

STORE IN OUTPUT BUFFER 

INCREMENT POINTER INTO OUTPUT BUFFER 

PICK UP HIGH BYTE OF ADDRESS 

ROTATE BITS 1,2,3 INTO LOW ORDER POSITION 

MASK OFF ALL BITS EXCEPT LOW THREE 

OR IN ASCII 0 

STORE IN OUTPUT BUFFER 

INCREMENT POINTER INTO OUTPUT BUFFER 

PICK UP HIGH BYTE OF ADDRESS 

SAVE LOW BIT IN THE CARRY FLAG 

PICK UP LOW BYTE OF ADDRESS 


cn O’D'^TTmX'K'rT:’ rnTfAm r’(~v'KTTTT-iT>rnr< -> T T m o 


m\ T T 


. m\ r T 
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MV I 

B,8 

?LOAD B WITH NO OF BYTES TO DUMP PER LINE 

NXTNUM: 

PUSH 

H 

'SAVE H&L 


LHLD 

LAST 

'LOAD ADDRESS OF LAST BYTE TO DUMP 


MOV 

A,L 

'DO THE DOUBLE WORD COMPARE AGAIN 


SUB 

E 



MOV 

A,H 



SBB 

D 



POP 

H 

RESTORE THE H&L REGISTERS 


JC 

LNDN 

'JUMP TO ROUTINE TO FINISH UP IF DONE 


MV I 

C,5 

'IF ANOTHER TO COME SEPARATE THEM BY 5 BLANKS 


CALL 

BLANK 



XRA 

A 

SET THE CARRY FLAG TO 0 


LDAX 

D 

GET BYTE TO DUMP 


CALL 

LAST3 

CALL ROUTINE TO CONVERT 3 DIGITS 


INX 

D 

INCREMENT POINTER TO DUMP NEXT BYTE 

CHKLN: 

DCR 

B 

DECREMENT LINE BYTE COUNTER 


JNZ 

NXTNUM 

CONVERT NEXT NUMBER IF IT WILL FIT ON LINE 


LX I 

B,OUT 

GET ADDRESS OF MONITOR CONTROL BLOCK 


CALL 

10 

WRITE OUT LINE 


JMP 

NEWLN 

JUMP TO WRITE OUT NEXT LINE 

LNDN: 

MVI 

C,8 

PAD LINE WITH 8 BLANKS FOR EACH NUMBER THAT 


CALL 

BLANK 

WOULD FIT 


DCR 

B 

DECREMENT NUMBERS THAT COULD FIT IN LINE 


JNZ 

LNDN 

LOOP UNTIL LINE FILLED WITH BLANKS 


LX I 

B,OUT 

GET ADDRESS OF MONITOR CONTROL BLOCK 


JMP 

10 

WRITE OUT LINE 

BLANK: 

MVI 

A,40Q 

PUT A ASCII BLANK IN A 

BL: 

MOV 

M,A 

STORE IT IN THE OUTPUT BUFFER 


INX 

H 

INCREMENT THE OUTPUT BUFFER POINTER 


DCR 

C 

DECREMENT THE NUMBER OF BLANKS TO STORE 


JNZ 

BL 

LOOP UNTIL ALL STORED 


RET 


RETURN TO CALLER 

LAST3: 

PUSH 

PSW 

SAVE BYTE TO CONVERT 


RAL 


ROTATE CARRY AND HIGH 2 BITS TO LOW ORDER 


RAL 


POSITION 


RAL 




ANI 

7 

'MASK OFF ALL BUT LOW ORDER THREE BITS 


ORI 

60Q 

;0R IN A ASCII 0 


MOV 

M,A 

; STORE DIGIT IN OUTPUT BUFFER 


INX 

H 

rINCREMENT THE OUTPUT BUFFER POINTER 


POP 

PSW 

?POP BYTE TO CONVERT 


PUSH 

PSW 

jSAVE FOR LATER ALSO 


RAR 


rROTATE BITS 3,4,5 INTO LOW ORDER POSITION 


RAR 




RAR 




ANI 

7 

?MASK OFF ALL BUT LOW THREE BITS 


ORI 

60Q 

?0R IN AN ASCII 0 


MOV 

M,A 

?STORE DIGIT IN OUTPUT BUFFER 


INX 

H 

?INCREMENT OUTPUT BUFFER POINTER 


POP 

PSW 

?POP BYTE TO CONVERT 


ANI 

7 

;MASK OFF ALL BUT LOW THREE BYTES 


ORI 

60Q 

;0R IN ASCII 0 


MOV 

M,A 

?STORE DIGIT IN OUTPUT BUFFER 


INX 

H 

?INCREMENT OUTPUT BUFFER POINTER 


RET 


?RETURN TO CALLER 
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OUT: 

DB 

22Q 

?MONITOR WRITE OPERATION CODE 


DB 

"LST" 

; SYMBOLIC DEVICE TO WRITE ON 


DW 

BUF 

: ADDRESS OF OUTPUT BUFFER 


DW 

72 

?WRITE OUT 72 CHARATERS 


DW 

STAT 

?ADDRESS OF STATUS WORD 

STAT: 

DW 

0 


FIRST: 

DW 

15100Q 


LAST: 

DW 

15272Q 


BUF: 

DS 

70 

RESERVE 70 MEMORY LOCATIONS 


DB 

15Q 

ASCII CARRIAGE RETURN 


DB 

12Q 

ASCII LINE FEED 


BEG 

DUMP 

i 

SETS ADDRESS OF PLACE TO START EXECUTING 
PROGRAM 


END 

DMP 


SENSE 

SWITCH 

15 FOR DUMP 



NOTE: AT THIS POINT THE PUNCH OR OUTPUT TAPE IS READIED FOR 
OUTPUT OF THE PROGRAM IN ABSOLUTE BINARY FORMAT(APPENDIX A). 
OUTPUT DONE 


UNDEFINED SYMBOLS 

SYMBOL TABLE 
HUMP 020000 
;RST 020234 
lmEWLN 020004 
BUF 020240 
LAST 020236 
LASTS 020165 
NXTNUM 020067 
LNDN 020133 
BLANK 020154 
CHKLN 020116 
OUT 020222 
BL 020156 
STAT 020232 
RUN DMP 


015100 

104 

040 

002 

007 

001 

105 

040 

003 

015110 

007 

001 

110 

040 

004 

007 

001 

114 

015120 

040 

005 

007 

001 

115 

040 

006 

007 

015130 

002 

123 

120 

040 

006 

007 

003 

120 

015140 

123 

127 

040 

006 

007 

001 

044 

040 

015150 

000 

000 

000 

000 

000 

000 

000 

000 

015160 

377 

377 

377 

377 

377 

377 

377 

377 

015170 

377 

377 

377 

377 

377 

377 

377 

377 

015200 

000 

000 

000 

000 

000 

000 

000 

000 

015210 

000 

022 

114 

123 

124 

272 

032 

016 

015220 

000 

073 

033 

022 

115 

101 

107 

000 

015230 

000 

016 

000 

073 

033 

061 

104 

115 

^ 5240 

120 

000 

040 

020 

115 

101 

107 

272 

^5250 

032 

110 

000 

073 

033 

335 

017 

065 

015260 

115 

101 

107 

377 

377 

377 

060 

000 

■015270 

043 

007 

122 
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V. Text Editor 



The editor via its four editing commands can create and modify source 
program files. The alter command is used to make corrections within a 
line, thus eliminating the need to replace all mistyped lines. The 
insert, delete, and replace commands have been improved to ease the job 
of modifying a program. 


Symbolic device names used by the Editor 

All symbolic device names used by the editor are open to the TY before a 
run, and should be changed only if the device is not correct. The 
symbolic device names are listed below along with mode information 
needed for proper operation. 

FIL - File I/O device name 

A - ASCII read mode should be specified 
T - Tabs should not be specified 
E - Can be speified if the user wants a listing 
Tabs will not be expanded 
ALT - Alter command I/O 

A - ASCII mode should not be scecified 
T - Tabs should be specified 
E - Echoing should not be specified 
LST - Write and print command I/O 

A ~ ASCII mode should be specified 
T - Tabs should be specified 
E - Echoing is not used during writing 


Buffer Area 


The first 2 K of memory following the editor is allocated as a 
buffer to store the lines of text to be edited . If the size or 
location of this buffer area needs to be altered, two addresses within 
the editor must be changed. The address of the beginning of the buffer 
starts at location 5124Q.'i the address of the end of the buffer starts 
at location 5530Q. ^ j 


Loading the Editor 

Open symbolic device ABS to the AC if the copy of the editor is on 
audio cassette or TY if it is on paper tape. The editors file name is 
EDT and is loaded by typing EDT<CR> . 

Example: 

To load the Editor from paper tape type: 

?OPN ABS,TY<CR> 

?EDT<CR> 

(TURN ON PAPER TAPE READER) 

START INPUT . , 
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/ (The asterisk is printed whenever the editor is ready for a 

.nmand) 

If after completing an edit and returning to the monitor you want 
to use the editor again, type: 

?EDT<CR> 

START INPUT 
* 

If you need to continue editing lines left in the buffer area when you 
last exited from the editor, use the R execution option. 

Example. 

?EDT(R) 

* 

Start input is not printed in this case and the buffer is not 
reinitialized. This feature is especially useful when assembling 
directly from the editors buffer. 


Range and Line Number Specifications 

When a range is called for by an instruction, the following syntax 
is required. 

Line Number,[ Line Number ] 


Line Numbers 

The following three types of line numbers are now recognized by the 
Editor . 

NUMBER(N) THE N'TH LINE IN THE BUFFER. 

.[ + OR - NUMBER ] RELATIVE ABOUT THE CURRENT LINE. 

*[ - NUMBER ] RELATIVE ABOUT THE LAST LINE IN THE BUFFER 

EXAMPLE. 

* p* 

Prints the last line in the buffer. 

*P10 

Prints the tenth line in the buffer. 

*P.+10 

Assuming this command was executed after the P10 command, line 20 would 
be printed. 


Editor Commands 


I [Line Number] Insert Command 

The insert command causes the editor to enter the insert mode at the 
line specified. After all lines to be entered have been typed, type a 
Control Z to return to the command level of the editor. If no line 
number is typed all lines are inserted before the first line. 
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D Range 

Deletes all lines in the 
R Range 

Deletes the lines in the 


Delete Command 
specified range. 

Replace Command 

range and enters the insert 



mode. 


P [ Range ] Print Command 

Prints all lines within the range or all lines in the buffer if no range 
is given. Line numbers are printed to the left side of the lines. 

W [ Range ] Write Command 

Same as print command except line numbers are not printed. 

String Search Command 
F[ String ][ <ESCAPE>[ Line Number ] ] 

The find command searches the buffer area starting at the given line 
number, printing the first line the string appears in. If no string is 
given, the string from the last find command issued is searched for. If 
no line number is typed, the editor starts searching at the current line 
plus 1 (ie .+1) . The escape is optional when not typing a line number. ^ 

S Save File Command 

Save command prints 
FILENAME^ 

An optional 3 character file name is typed followed by a carriage 
return. The editor responds by typing CHANGE SENSE SWITCH 1.5 As soon 
as this message has finished printing turn on the device that the file 
is to be dumped on. Change the position of sense switch 15 to indicate 
that the device is ready. When all lines have been dumped, the editor 
returns to the monitor. When a file name is given, a header block is 
written containing the file name. If no file name was typed, no header 
block is output. 

L Load File Command 

The load command prints 
FILENAME= 

An optional 3 character file name is typed, followed by a carriage 
return. If a file name is typed, a header block containing the proper 
file name is searched for and the file following it is loaded into the 
buffer. If no file name is typed, all lines are loaded until an end of 
file is read. This command reads files from symbolic device FIL. 
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"''SCAPE> Backup Command 

li an escape is typed to the editor a dollar sign is echoed and and the 
current line minus 1(ie .-1) is typed. 

<LF> Next Line Command 

If a line feed is typed to the editor the current line plus l$ie.+l) is 
printed. 


E 


Exit Command 


Causes the editor buffer read pointer to be reset to the beginning of 
the buffer, and returns to the monitor. 


A Line Number Alter Command 

The alter command puts the Editor into Alter mode, allowing the 
programmer to change lines without replacing them. The following 
command characters are recognized but not echoed, and all commands can 
De prefixed by a repetition factor of up to six digits. This repetition 
factor is referred to as “N" in the following description, and is 
assumed to be one(l) if not given. 


Alter Mode Commands 

D - Deletes the next N characters in line. A slash is output 
followed by all characters deleted and a closing slash. 

Example: 

The current line is 
BLAB: MOV A,B 

*A. Give Alter Command 

Type 3D. The editor responds by typing /BLA/ indicating that 
BLA has been deleted from the line. 

I - Inserts all characters typed after the I into the line at 
the current place in the line. All characters are echoed. 
Typing an <ESCAPE> returns you to the alter mode. 

R ~ Deletes the next N characters in the line and enters the 
insert mode. 

S - Typing an S followed by any character will cause a search 
for the N'th occurance of that character. 

Blank - Typing a blank will cause the next N characters in the 
old line to be copied into the new line and to be printed out. 

<CR> - Typing a carriage return prints out the rest of the old 
line, and at the same time inserts the characters into the new 
line. The old line is be replaced by the new one and control 
is returned to the command level of the editor. 
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Q - Causes control to return to the conunand level of the editor 
without replacing the old line. This command is used to abort 
an alter during which you made a bad mistake. 


Sample Edit 

In the following example characters typed as alter mode commands that 
would not be echoed are enclosed in parentheses. 

?EDT<CR> 

START INPUT 
*I<CR> 

THIS IS A DEMONSTRATON 
OF THE EDITOR. 

<CONTROL Z> 

*A1<CR> 

(2ST)THIS IS A DEMONSTRA(<SPACE>)T(I)I(<ESCAPE>)<CR> 

*W<CR> 

THIS IS A DEMONSTRATION 
OF THE EDITOR. 

*A2<CR> 

(3<SPACE>)OF {2D)/TH/<CR> 

W2<CR> 

OF E EDITOR. 

A.<CR> 

(SE)OF (R)/E/THE(<ESCAPE>)<CR> 

*W<CR> 

THIS IS A DEMONSTRATION 
OF THE EDITOR. 

*E<CR> 

7 


EDITOR ERROR MESSAGES 

1) BAD CMD - Indicates that the first character of a command line was 
not a valid editor command. 

2) END OF BUFFER - The edit buffer is full. There is no space for any 
additional text. 

3) BAD LINE NUMBER - The characters following a command do not represent 
a legal line number. 

4) TOO MANY DIGITS - The number entered contains too many digits. 
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DBG DOCUMENTATION VERSION 1.0 


Package Summary: 

The DEBUG package provides the user with the following capabilities: 

1) Display memory locations, registers, or flags in any of 
several output I/O modes (including a symbolic 
instruction mode). 

2) Modify memory locations, registers, or flags using 
corresponding input modes. 

3) Set (or display or remove) breakpoints in the code to 
be debugged. 

4) Enter and execute user code either 

A) at a specified location or 

B) automatically in such a way as to proceed 
properly from the most recently encountered 
breakpoint. 

The commands accepted by DBG are 1-character commands or combinations of 
1-character commands and data. These commands will be described in the 
,j:..e‘mainder of this document. 

Note: In the examples that follow, <CR> represents a carriage return 

character, <LF> a line feed, <RUBOUT> a delete character, <TAB> a tab 
(Control-I), <UPARROW>. 

Numbers may be typed in either as octal (the default) or as decimal by 
preceding the number with a number sign (#). Therefore #255 is equal to 
377. If a single byte value is expected and a value greater than 377 is 
input, only the low order eight bits (byte) of the value is used. 

RUBOUT: 

If an error is made while entering commands or data, a rubout character 
can be typed at any time to abort user input. DBG will type a question 
mark (?) and begin accepting commands on a new line. 

I/O Modes: 

Information is usually displayed and then re-entered in accordance with 
the current I/O mode. The I/O mode can be set by typing an ESCAPE or 
dollar sign (echoed $) followed by a character that specifies the I/O 
mode: 


$0 Specifies octal mode. 

$D Specifies decimal mode. 

$W Specifies double byte octal mode. 

$A Specifies ASCII mode. 

$S Specifies symbolic instruction mode. 
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$0 Mode 

In octal mode, each location is typed as an octal value between 0 and 
377. The line feed or up arrow characters always advance or back up the 
location counter by 1. input is expected to be a one byte value between 
0 and 377. Example: 

10/ 0 55<CR> 

10/ 55 #48<CR> 

10/ 60 


$D Mode 

Decimal I/O mode is identical to $0 (octal) mode except that output is 
decimal and input is always assumed to be decimal (no number sign should 
precede input). 


$W Mode 

In double byte octal mode ($W) the location and location plus one are 
interpreted as a double byte (16 bit) quantity. Assuming location 10 
contains 0 and location 11 contains 1, then: 

$W 10/ 400 200 
10/ 200 <LF> 

12/ 0 


Line feed 
counter. 

and up arrow always add 

or 

subtract 

two 

from 

the location 


The value 

re-entered in $W mode 

(the 

200 in 

the 

above 

example) is 



interpreted as being a 16 bit (double byte) value and is stored in 
memory low order byte first, high order byte second. 


$A Mode 

ASCII mode is used to type out or input ASCII information. When a 
location is opened in ASCII mode, the ASCII representation of the byte 
stored there is typed: 

$0 10/ 0 101<CR> 

$A/ 

10/ A 

When ASCII information is input, DBG expects the user to type a 
delimiter, a string of ASCII characters, and then a terminating 
delimiter which is the same as the initial delimiter. 

Example: 
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10/ A 

xiiis enters the character B into location 10. The delimiters (”) are not 
stored in memory. Multi-character strings may be entered: 

10/ B "FOO" 

(Note: One should not try to use the special characters <CR>, <LF>, 

<TAB>, '',<ESC OR $>, <RUBOUT>, =, i, .,+,-,/ as delimiters as 
these characters have special meanings for DBG. Double quote and single 
quote should suffice for most string entry.) Typing slash (/) after a 
string has been entered will reopen the first location in the string: 

10/ A “FOOV 
10/ F 

Typing <LF> after a string has been entered will open the location after 
the last location stored in: 

10/ A ‘•FOO‘'<LF> 

13/ Z 

The only character which may not be entered in an ASCII string is 
<RUBOUT>. <RUBOUT> may be used to terminate the entry of an ASCII 
string. However, any characters that had- been entered prior to the 
typing of the slash are still there. 

' / A *'FO<RUBOUT> 

10/ F <LF> - 
11 / 0 

Special note: The high order bit (D7) of data entered via $A mode will 
always be set to zero. 


$S Mode 

Symbolic (instruction) mode is used to type out locations as if they 
were instructions, and to enter instructions into memory using their 
mnemonics. Example (supposing locations 7-17 octal contained 0): 

$S 5/ NOP LXI H,#8192<LF> 

10/ NOP MVI B,100<LF> 

12/ NOP MVI M,0<LF> 

14/ NOP INX H<LF> 

15/ NOP DCR B<LF> 

16/ NOP JNZ 12<LF> 

17/ NOP JMP 100<CR> 

In this example, a short program has been entered to set the 64 decimal 
bytes starting at location 8192 decimal to zero. After it finishes, the 
nrogram returns to the monitor by jumping to location 100 octal. 

3imal numbers may be used in the address or immediate fields of an 
instruction by preceding them with a number sign (#). DBG may be used 
in the fashion demonstrated above to 'improvise' programs. After a 
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program has been written and debugged, the monitor DMP command may be 
used to store them on cassette or paper tape. The symbolic I/O mode is 
often very useful in patching or changing instructions in existing 
programs to fix bugs temporarily before the source code is re-assembled. 

<LF> in symbolic mode opens the location which is the current location 
plus the number of bytes of the instruction typed out (or just entered) 
- 1 . 

<UPARROW> opens the current location minus the number of bytes of the 
instuction typed out ( or just entered). This may or may not be 
meaningful, as the previous intruction may not be the same number of 
bytes as the one just typed in or displayed. 

The default mode (when DBG is first entered) is octal. 

Slash: 

A memory location can be displayed by typing its octal address followed 
by a "/•■. This address may be octal or decimal and is independent of 
the I/O mode. Thus 

30/ 

or 

#24/ 

Will cause the contents of octal location 30 to be displayed in the 
current I/O mode. In the case of symbolic I/O mode, up to 3 bytes (e. 
g. a JMP) may be displayed depending on the type of instruction found 
in the first byte. Registers can also be displayed by typing a "/” 
after their 1-character names. For example 

L/ 

Will cause the contents of the L register to be displayed in the current 
I/O mode. (The value actually displayed is not actually the L register 
but a memory location used to maintain the user's L register while DBG 
executes.) 

The flag register (condition codes) is displayed similarly by typing 
F/ 

Since the contents of the flag register is usually interpreted as 
settings of the carry (C) zero (Z) sign (S), parity (P) and half carry 
(H) flags, a special type out mode has been provided so the user can 
display the flags in a meaningful fashion without having to interpret 
the octal value of the flags: 
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P/ 106 IZP 

f 

.n this example, the flag register was opened in octal mode. In order 
to display which flags were set, the character I was typed and the 
debug package typed back 'ZP' which meant that the zero and parity flags 
were set. The exclamation character may be used to type out any 
location in 'CONDITION CODE' format. This can prove useful when 
examining condition codes that have been pushed on the stack by the 
•PUSH PSW instruction. 

There is no corresponding method to enter condition codes symbolically. 
The user must re-enter any change he wishes to make in the current I/O 
mode (octal is suggested). See the table below under the F register for 
the bit positions of the different flags. 

The stack pointer may be displayed by typing: 

S/ 

This will display the lower 8 bits of the stack pointer in the current 
I/O mode. To display the high 8 bits, type linefeed. Typing TAB 
(Control I) after opening the low eight bits of a register or location 
will open the location pointed to by the register pair or double byte 
memory pointer. For example, to look at the byte pointed to by the H 
and L registers, type: 

t'^4 <TAB> 

v)dA/ <The contents of this location> 

In this example, H would have contained 12 octal. A TAB is also useful 
when the I/O mode is symbolic and a 3-byte instruction has just been 
displayed. The current location pointer will be set to the address part 
of the displayed instruction, and the contents at that new address will 
be displayed. This feature permits simplified program tracing when 
jumps and calls are encountered. 

70/ JMP 5000 <TAB> 

5000/ SHLD 4750 


The user program registers are stored inside DBG when a breakpoint is 
encountered during the execution of a user program. The order of the 
registers in memory is as follows: 
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REGISTER 

NAME 

F (CONDITION CODES) 

BIT MEANING (IF = 1) 


0 CARRY 

2 EVEN PARITY (NUMBER OF ONES IN RESULT WAS EVEN) 

4 HALF CARRY FOR BCD OPERATIONS 

6 ZERO 

7 SIGN (ONE MEANS MSB OF RESULT WAS 1) 

A 

C 

B 

E 

D 

L 

H 

S (STACK LOW EIGHT BITS) 

(STACK HIGH EIGHT BITS) 

Thus, once a particular register is opened, linefeeds and/or uparrows 
may be used to display the register above or below the one currently 
opened. 


DOT; ( 

The address of the most recently displayed location is saved in a 
"CURRENT LOCATION POINTER". The location at that address can be 
redisplayed at any time (even after changing I/O modes) by typing 

./ 

or simply 

/ 

The dot (which can be optionally omitted) can be thought of as a symbol 
for the address of the current display location. This pointer can be 
offset in either direction using a + or - and a number. Thus: 

. +5/ 

displays the contents 5 locations after the current one, and 
-33/ 

displays the contents of the location that is 33 octal locations before 
the current one. (As before, typing of the is optional.) 
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'■viultiple subtractions and additions may be performed to calculate 
Idresses or other sixteen bit (two byte) values: 

100+20-30/ 

70/ 25 


The equal sign (=) 

The equal sign may be used to type out the current value of calculation: 
100+20-30=70 -#8=60 


Semicolon: 

In general, a slash can be typed at any time to display the current 
location in accordance with the current I/O mode. A semicolon can be 
typed at any time to display the current location in octal independent 
of current I/O mode. The I/O mode is not changed by a semicolon, but if 
location modifying information immediately follows the octal display, 
the input information will be accepted in octal. Thus if the current 
I/O mode were symbolic the octal equivalent of a symbolic instruction at 
location 100 could be examined easily with a semicolon as follows: 

100/ MOV A,C; 171 

Line Feed and Up-Arrow: 

A line feed (usually typed after some location has been displayed) 
causes the current location pointer to be advanced to the next location, 
and that location will be displayed. This permits rapid display of 
successive memory locations. If the current I/O mode is symbolic the 
current location pointer advances by the number of bytes in the 
instruction just displayed. Thus a rapid symbolic display of program 
segments is possible. 

The up-arrow command acts similarly to a line feed except that it 
decrements rather than increments the location pointer. 

Location Modification: 

Immediately after a location has been displayed it is subject to 
modification. (Susceptability to accidental modification at this point 
can be removed by typing a carriage return.) Input for modifying the 
location must conform to the current I/O mode. (Exception: After a 
semicolon as described above.) A failure to conform to the current I/O 
mode, or entry of uninterpretable data will result in rejection of the 
input data. (A question mark will be typed by DBG.) In general, spaces 
are always ignored on input and can be typed or omitted with no effect 
in any I/O mode. 


f 
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The following special characters; 

V, 

<CR>, <LF>, /, <TAB>, +, <ESCAPE>, I, =, <UPARROW> 

Will always cause termination of data input strings as they have special 
meaning to DBG. 

A "/" can be used as a terminator to get an automatic feedback of the 
typed input data. In the following example, the I/O mode is symbolic. 

./JMP 204 LXIB, 12 3/ 

200/ LXI B,123 

Three bytes starting at location 200 are set by the above commands. The 
second line was typed entirely by DBG in response to the "/" terminator. 

This sequence checks both the correctness of the entered data (which at 
first looks questionable) and the previously uncertain value for the 
current location pointer. 

If input is purposely terminated by a line feed, up-arrow, slash, or 
tab, the input will be processed and the appropriate new location will 
be displayed. Thus, for example, the following sequence demonstrates 
clearing of a small block of memory locations that previously all 
contained 377's: 

30/ 377 0<LF> 

31/ 377 0<LF> 

32/ 377 0<LF> 

33/ 377 0<LF> 

In the above sequence DBG typed all but the initial "30/" and the 
repeated "0 <LF>"'S. 

Breakpoints: 

Breakpoints are set using the X command. For example: 

30X 

causes the first unused breakpoint to be set at location 30. Similarly, 


or just 
X 

will cause a breakpoint to be set at the current location pointer. 

There is capacity for setting 8 different breakpoints numbered 
internally 0 through 7. When an x command is executed the first free 
oreakpoint is allocated to the breakpoint being set. If there are no 
free breakpoints, a question mark is printed, and one of the existing 
breakpoints must be deleted before a new one can be set. When any 
breakpoint is encountered the address of that breakpoint is always 
displayed for the user by DBG; 
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"^BREAK @1000 

means that breakpoint number five was encountered at octal location 
1000 . 

It is permissable to change the instruction at any breakpoint at anytime 
while running DBG. 

2 BREAK @1000 

1000/ XRA A ORA A<CR> 

If an RST instruction is executed which is the same RST used by DBG but 
was not inserted by DBG as a breakpoint, DBG will type out the 
breakpoint number as 10: 

10 BREAK @205 

It is possible to proceed from such breakpoints, but this kind of 
conflict between user RST's and DBG RST's usually indicates that a user 
RST service routine is not being executed and DBG is intercepting the 
RST. Under these circumstances, the breakpoint RST should be changed so 
it does not conflict with user RST's. 

Changing the RST used by DBG. 

^t may become necessary to change the RST used by the debug package to 
lother RST. To accomplish this you can use DBG itself to make a 
modification which will allow you to set the breakpoint RST to any of 
the eight possible RST's. Start looking for the first MVI instruction 
in DBG by entering symbolic typeout mode and line feeding until you find 


it. 




$s 

CR> 


;OPEN SYMBOLIC MODE 

12722/ 

ETC. 

SHLD 4205 

<LF> 

;OR WHATEVER 

13000/ 

MVI A,377 


;DISPLAY RST SETUP INSTRUCTION 

13000G 

MVI A,317 

<CR> 

;CHANGE IT TO RST 1. 

;RESTART DEBUG PACKAGE 


It is important to note that when DBG is started, it always initializes 
the appropriate RST location (0,10,20,30,40,50,60,70 octal) to a JMP 
instruction to the breakpoint handling code inside DBG. Thus, when DBG 
is started initially, it will always clobber (store into) locations 
60,61 and 62 octal with a JMP instruction. 
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Checking Breakpoints: 

The Q command causes all program set breakpoints to be displayed. 

Example (assuming DBG has just been started) : 

10X 

20X 

377X 

Q 

0@10 

1@20 

20377 

Each breakpoint is typed out by its number, an at (@) sign, and then the 
address where the breakpoint is set. Any breakpoints that are not 
mentioned by a 'Q' command are not in use. 

Removing Breakpoints: 

Typing Y (carriage return) will remove all breakpoints. Typing Y 
followed by <DIGIT> will remove breakpoint DIGIT>: 

YS - 
Y 

Execution: 

The 'G' or go command permits entry of user code at an arbitrary 
location. The address should be followed by a G. Thus: 

30G 

will cause execution to begin at octal location 30. As in other 
situations the current location pointer can be used in place of an 
address. Thus 


.G 


or simply 
G 

will cause execution to begin at the user address indicated by the 
current location pointer. 

If a user program loops endlessly (a typical symptom is that no response 
is made to input) the debug package can be re-entered by stopping the 
program (either with Control-C if monitor interrupts are being used or 
by manually stopping the machine) and restarting DBG from the monitor or 
at its starting location. 
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Proceeding from a Breakpoint: 

,y 

If it is desired to proceed from the last encountered breakpoint, the 
single character command "P*' can be used. Restrictions: This command 
cannot be used if no break point has yet been encountered during 
execution of user code. If this is tried, a question mark will be 
typed. 


Multiple Proceeds: 

A number before a P has a different meaning than before a G. Such a 
number indicates the number of times a P command should be executed (the 
number of times that any encountered breakpoint should be ignored) 
before control is returned to DBG. Thus the command 

30P 

will cause execution to proceed in the user program until breakpoints 
nave been encountered 30 (octal) times. This feature is especially 
useful in proceeding from a loop that contains a breakpoint. 

Typing out a Sequence of Locations: 

The ”T‘' command is used to type out a sequence of locations in the 
current I/O mode. The format of the command is: 

X,YT 

where X is the beginning address and Y is the ending address. For 
instance: 

100,500T 

would type out the first 256 bytes of the monitor in the current I/O 
mode. 


DBG System Documentation 

The debug package resides directly above the monitor. Whenever the 
debug package is entered, it saves the user registers in memory inside 
the debug package. It then replaces any breakpoints with the original 
instruction. The RST location is then initialized to point to the DBG 
breakpoint service routine. 

When a 'G' or 'P' command is typed, DBG replaces all instructions which 
have breakpoints set at their locations with the DBG breakpoint RST. 
The original instruction is saved in a table inside DBG so that it may 
be restored if DBG is restarted or a breakpoint is encountered. Then 
all the original user registers are restored. If this is a 'P' command, 
a complicated sequence of operations is performed to correctly execute 
the instruction located at the breakpoint address. This is especially 
difficult for CALL'S and RST's, as the instructions are actually 
xecuted inside the debug package and not at the breakpoint location, 
.fter simulation of the breakpointed instruction is finished, DBG jumps 
to the instruction after the one breakpointed. (In the case of true 
conditional JMP's, CALL'S or RST's DBG jumps to the proper location). 
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When a breakpoint RST is executed, DBG saves all the user registers 
restores breakpointed instructions. 

The debug package program name is DBG and is loaded by typing: 

?DBG<CR> 

(RUN THE TAPE) 

DEBUG 


and 


Debug starts at 5100Q and ends at 11552Q, allowing AM2 to be in memory 
at the same time. While Debug is running, the MONITOR can be re-entered 
by typing an R. 
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APPENDIX 

A 


ABSOLUTE LOAD TAPE 

FORMAT 




BEGIN/NAME 

RECORD 


BYTE 

1 

125 OCTAL 


BEGIN SYNC 

BYTES 2-4 

NAME 


PROGRAM NAME 

BYTES 5-N 

COMMENTS 


END STATEMENT DOCUMENTATION 
(I.E.PROGRAM REVISION AND DATE) 

BYTE 

N+1 

15 OCTAL / 

3 D 

0 ^ 

TERMINTATES THE PROGRAM NAME 
RECORD 


PROGRAM LOAD RECORD 

- 

BYTE 

1 

74 OCTAL 

^ i- - 

LOAD SYNC BYTE 

BYTE 

2 

0-377 OCTAL vti" 

NO. OF LOAD BYTES(N) 

BYTE 

3 

L.S. BYTE 


LOAD ADDRESS 

BYTE 

4 

M.S. BYTE 

DATA BYTES 

II li 

BYTE 

N+5 

* 


CHECKSUM BYTE 


* THE CHECKSUM IS GENERATED BY ADDING W/0 CARRY ALL BYTES 
EXCEPT THE FIRST TWO. 

END-OF-FILE RECORD 

BYTE 1 170 OCTAL / PAPER/AUDIO CASSETTE EOF 


BYTE 2-3 


BEGIN EXECUTION ADDRESS 



1 
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1 


APPENDIX B 
ASSEMBLY MEMORY MAP 


MEMORY BLOCKS 


BOUNDARIES 


USER SPACE 


SYMBOL TABLE 
(CHAR. LENGTH 
+3 BYTES/SYMBOL) 


TEMPORARY 

ASSEMBLER 

VARIABLES 

ASSEMBLER .yc 
PROGRAM 
STORAGE ^ 
(VERSION 1) 


MONITOR 
TABLES & 
HANDLERS 


RESTART 

TRAPS 


TOP OF MEMORY 

FIRST WORD OF PROGRAM STORAGE 
(SET BY ORG OR ORR IF GIVEN) 

SYMBOL TABLE BUILDS UP FROM HERE 

FIRST WORD OF VARIABLE STORAGE 


FIRST WORD OF ASSEMBLER 
(5100Q) j/. 



BOTTOM OF MEMORY 


RECOMENDED MEMORY LAYOUT 
MEMORY BLOCKS 

EDITOR BUFFER 
AREA 

I USER AREA 

I SYMBOL TABLE 

ASSEMBLER 
(VERSION 2) 

' EDITOR 

MONITOR 


WITH EDITOR AND ASSEMBLER 
BOUNDARIES 
TOPOF MEMORY 

FIRST WORD OF BUFFER 

- 7 ^ -7 /’ ;> 

, , ^ 
) - 

FIRST WORD OF ASSEMBLER 
(11553Q) 

DEFAULT START OF EDIT BUFFER 

I t y t ■ ^ ; r< 

EDITOR STARTS AT 5100Q 

oii 


BOTTOM OF MEMORY 
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Appendix C 


Assembler Errars 

Error codes are the first two characters on the line following 
occurance of an error. Error codes replace the characters that are 
normally echoed on a TTY or Comter terminal. 


B# No origin specified 

|D# Double defined symbol 

«I# Illegal operand 

Undefined byte symbol 

String not allowed 

Name value must be defined 

ORR or ORG must be defined value 

N# No name defined 

0# Memory overflow 

Program space not large enough 

0# Symbol table overflow 

Program storage should begin at higher memory address 

S# Symbol undefined 


Monitor Errors 


All monitor error messages are output in place of the 2 spaces in 
the monitor prompt. 

Example: 

?0PN FIL,EV,A 
H*? 


4 * Attempt to store over monitor 

^ No program can load before 5100Q. 

C* Typing a Control C caused a return to the monitor. 


D* Name already in PTL 

Use the CLR utility to remove the program name from the PTL. 





I/O table full 

Use the CLS utility program to close an unused symbolic name 
freeing space in the table to open the name you need. 


xi* Hardware device undefined 

An attempt was made to open a symbolic name to a nonexistant 
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L* 


M* 




0 * 

P* 


S* 

u* 


hardware device. 

Load error. 

A checks-um error occured while loading a program. 

Memory malfunction 
Memory not working or nonexistent. 

After storing into memory the stored byte did not compare 
exactly with the value stored. This is checked when the 
monitor loads a program. 

I/O device name not open 

Before trying to read from a symbolic device, that device 
should be opened. See open command under monitor utility 
programs. 

Overflow of numeric argument in command line, 
program table (PTL) full. 

use the CLR utility to clear the name of a program 
that is'nt needed any longer. 

Syntax error in command line 

program name not in PTL 

Illegal operation 

An illegal operation code was given in a monitor control block. 


V* 
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Appendix D. 

If any special purpose I/O handlers are needed, the following 
addresses may be useful. 

Console input interrupt routine - 4410Q 09^!^ H 

Console input non-interrupt routine - 3432Q ^? '/? ' 

Console output routine - 3416Q C?'? 0 '^ *' 

Console tab counter - 4611Q o'9S9 - 

ACR input routine - 4516Q 
ACR output routine - 4527Q j-{ 

ACR tab counter - 4614Q o9^c 
Edit buffer read routine - 3370Q 
High speed reader routine - 4474Q 


fJ O £<„; 'T 

0 097^ 


The structure of the monitor table that would need to be modified 


is as follows: 

DB 

DW 

DW 

DW 


There is room in 


DN" 

DEVIN 

DEVOUT 

DEVTAB 


TWO CHARACTER DEVICE NAME 

ADDRESS OF DEVICE INPUT ROUTINE 

ADDRESS OF DEVICE OUTPUT ROUTINE 

ADDRESS OF DEVICE TAB COUNTER 

THIS IS ONE BYTE OF STORAGE USED 

TO STORE INFORMATION ON THE CURSOR POSITION 


the table for an entry to be added at location 220Q. 


P 9 O' P ' 


Example: 


In order to echo the input from the ACR on your terminal and to 
fer to it in an OPN command as "AT", add the following at location 
z20Q: 


TABL: 


DB 

"AT" 




DW 

4516Q 

;THIS 

FORCES 

INPUT FROM THE ACR 

DW 

3416Q 

;THIS 

CAUSES 

OUTPUT TO BE SENT TO THE CONSOLE 

DW 

DS 

TABL 

1 

;THIS 

ALLOWS 

THE TABS TO WORK CORRECTLY 


To use monitor I/O with a device not supported by MITS, write your 
own handler and put it in high memory. Input routines should return a 
character in the A register while output routines should output the 
character in the A register. The routine should check the status of the 
device, loop until ready, and perform any character conversions if 
needed(ie. BAUDOT to ASCII or ASCII to BAUDOT). 


Example: 

A high speed paper tape reader is connected to I/O port 12 and 13. Its 
motion is controlled by the output to port 13. A 1 turns the reader on 
and a 0 turns it off. 

Put the following routine in unused memory(probably in the highest 
locations in your machine). 


HSRD: MVI 

A,1 

;SET A = TO 1 


OUT 

13Q 

;TURN ON READER 

/ 

IN 

12Q 



RAR 


;ROTATE STATUS BIT INTO THE CARRY FLAG 
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JC 

TRMIN 

;WAIT 

FOR INPUT READY BIT TO GO LOW 

XRA 

A 



OUT 

13Q 

;SHUT 

READER OFF 

IN 

13Q 

;INPUT 

THE CHAR FROM TERMINAL 

RET 





AT LOCATION 220Q PUT THE FOLLOWING: 

DB ‘'PT" ; DEVICE NAME 

DW HERD ;ADDRESS OF READER INPUT ROUTINE 

DW 

DW ;SINCE NO OUTPUT ROUTINE TAB COUNTER NOT NEEDED 

To open ABS to the high speed reader in order to read in absolute 
•program tapes, use the following open command. 

?OPN ABS,PT 
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Appendix E. 


When the Altair is first turned on, there is random garbage in its 
memory. The monitor is supplied on a paper tape or audio cassette. 
Somehow the information on the paper tape or cassette must be 
transferred into the computer. Programs that perform this type of 
information transfer are called Loaders. 

Since initially there is nothing of use in memory, you must toggle 
in the bootstrap loader, using the switches on the front panel. This 
loader will then load the MONITOR. So, to load the MONITOR, follow 
these steps: 

1) Turn the Altair ON. 

2) Raise the STOP switch and RESET switch simultaneously. 

3) Turn your terminal (usually a Teletype) to LINE. 

Because the instructions must be- toggled in via the switches on the 
front panel, it is rather inconvenient to specify the positions of each 
switch as up or down. Therefore, the switches are arranged in groups of 
3 as indicated by the broken lines below switches 0-15. To specify the 
sitions of each switch we use the numbers 0-7 as shown below: 



Switches 



Leftmost 

Middle 

Rightmost 

Number 

Down 

Down 

Down 

0 

Down 

Down 

up 

1 

Down 

up 

Down 

2 

Down 

up 

up 

3 

up 

Down 

Down 

4 

up 

Down 

up 

5 

up 

up 

Down 

6 

up 

up 

up 

7 


So, to put the octal number 315 in switches 0-7, the switches would have 
the following positions: 

Switches 

7 6/5 4 3/2 1 0 

UP UP / DOWN DOWN UP / UP DOWN UP 

3 1 5 

Note that switches 8-15 were not used. Switches 0-7 correspond to the 
bitches labeled DATA on the front panel. A memory address uses all 16 
,/itches. 
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The Bootstrap Loader is the following program: 

The following Bootstrap Loader is for users loading from paper tape 
and using a REV 1 Serial I/O board. 


Address/Data 

000 

041 

001 

256 

002 

017 

003 

061 

004 

0 22 

005 

000 

006 

333 

007 

000 

010 

017 ' 

011 

330 

012 

333 

013 

001 

014 

275 

015 

310 

016 

055 

017 

167 

020 

300 

021 

351 

022 

003 

023 

000 


The following 21 byte Bootstrap Loader is for users loading from paper 
tape and using a REV 0 Serial I/O board on which the update changing the 
flag bits has not been made. If the update has been made, use the above 
Bootstrap loader. 


000 

041 

001 

256 

002 

017 

003 

061 

004 

0 23 -- 

005 

000 

006 

333 

007 

000 

010 

346 - 

011 

040 

012 

310 

013 

333 

014 

001 

015 

275 

016 

310 

017 

055 

020 

167 

021 

300 

022 

351 

023 

003 

024 

000 
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he following Bootstrap Loader is for users with the MONITOR supplied on 
cin Audio Cassette. 


000 ^ 

041 

V 

001 

256 

/\^ 

002 

.017 

Of- 

003 

061 

3 ! 

004 

022 

1 Z 

005 

000 

OO 

006 

333 

Pi3 

007 

006 

>- [=/\ 

010 

017 

0 f 

011 

330 

0 s 

012 

333 

D5 

013 

007 

y 6 

014 

275 

OP 

015 

310 

C 

016 

055 

H P 

017 

167 

/ / 

020 

300 

Co 

021 

351 


022 

00 3 

0 3 

023 

000 


' BOOTSTRAP 


000 

041 


001 

256 


002 

017 


003 

061 


004 

023 


005 

000 


006 

333 


007 

000 


010 

346 


011 

040 


012 

310 


013 

333 


014 

001 


015 

275 


016 

310 


017 

055 


020 

167 


021 

300 


022 

351 


023 

003 


024 

000 


BOOTSTRAP 

000 

076 


001 

003 


002 

323 


003 

020 


004 
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005 

021 

(=2 STOP BITS 

006 

323 

025=1 STOP BIT) 

007 

020 


010 

041 


011 

256 


012 

017 


013 

061 


014 

032 


015 

000 


016 

333 


017 

020 


020 

017 


021 

320 


022 

333 


023 

021 


024 

275 


025 

310 


026 

055 


027 

167 


030 

300 


031 

351 


032 

013 


033 

000 



4 PIO BOOTSTRAP 


000 

257 

001 

323 

002 

020 

003 

323 

004 

021 

005 

076 

006 

004 

007 

323 

010 

020 

011 

041 

012 

256 

013 

017 

014 

061 

015 

034 

016 

000 

017 

333 

020 

020 

021 

346 

022 

100 

023 

310 

024 

333 

025 

021 

026 

275 

027 

310 

030 

055 

031 

167 

032 

300 

033 

351 


(m A 
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035 000 

MITS HIGH SPEED READER BOOT 



CjO f 


000 

257 

001 

323 

002 

020 

003 

323 

004 

021 

005 

323 

006 

022 

007 

057 

010 

323 

011 

023 

012 

076 

013 

014 

014 

323 

015 

020 

016 

076 

017 

004 

020 

323 

021 

022 

022 

076 

023 

012 

024 

323 

025 

023 

026 

041 

027 

256 

030 

017 

031 

061 

032 

051 

033 

000 

034 

333 

035 

020 

036 

346 

037 

100 

0 40 

310 

041 

333 

042 

021 

043 

275 

044 

310 

045 

055 

046 

167 

047 

300 

050 

351 

051 

031 

052 

000 

to load 

the Bootstrap Loader 


4 ) 

lil 


5) 


Put switches 0—15 in the Down position. 

Raise EXAMINE. 

Put- 041 (thp data for addroc;?! in cT.iif-r-Hoo n n 
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7) Raise DEPOSIT. 

8) Put the data for the next address in switches 0-7 
(For address 001 this is 175) 

9) Depress DEPOSIT NEXT. 

10) Repeat steps 8-9 until the entire Loader is toggled in. 


Next check that the Bootstrap Loader is in correctly? 

11) Put switches 0-15 in the Down position. 

12) Raise EXAMINE. 

13) Check that lights D0-D7 correspond with the data that should be 

in address 000. A light 'on' means the switch was up; A light 

'off means the switch was Down. So for address 000, lights 
D1-D4 and D6-D7 should be off, and lights D0 and D5 should be 
on. 



If the correct value is there, go to 
If the value is wrong, go to the next 

step 16. 
step, 14. 



14) 

Put the correct value in switches 0-7 

• 



15) 

Raise DEPOSIT. 





16) 

Depress EXAMINE NEXT. 





17) 

If you have not checked the 
steps 13-16 until you have. 

entire 

Bootstrap 

Loader, Repeat 

18) 

If you found a mistake, go 
Bootstrap Loader again. 

back to 

step 11 

and 

check the 

19) 

Put the tape of the MONITOR 

into the 

tape reader 

. Be 

sure the 


TAPE is positioned at the beginning of the leader. The leader 
is the section of tape at the beginning with 6 out of the 8 
holes punched. 

If you are loading from Audio Cassette, put the cassette in the 
recorder. Be sure the tape is fully rewound. 

20) Put switches 0-15 in the Down position. 



21 ) 


Raise EXAMINE. 
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3) There are six different Bootstrap Loaders, one for each of the 

six types of I/O boards listed in the load option chart. Be 
sure that you use the correct one for your particular board. 

LOAD OPTIONS 




OCTAL 

STATUS BITS 

OCTAL 

LOAD DEVICE 

SWITCHES UP 

CHANNELS 

ACTIVE 

MASKS 

^SIOA,B,C 
(NOT REV 0) 

NONE 

0,1 


LOW 

1/200 

ACR 

A15(AND 

TERMINAL OPTS.) 

6,7 


LOW 

1,200 


‘SIOA,B,C A14 0,1 HIGH 40/2 

(REV 0) 


88-PIO 

A13 

0,1 

1, . high 

I V 

2/1 

3/7 ' on 7 

4PI0 

A12 

20,21 

id" Y 

HIGH 

100/100 

3ir C 

2SI0 

A10 (AND All 

20,21 

HIGH 

1/2 

/J/ T 0 )^/7 / 


UP=1 STOP BIT 






D0WN=2 STOP BITS) 





23) 

If the load device is an 

ACR, the 

terminal options (see 

second V 


chart) can be set on the switches (along with A15) before the 
loading is done. If A15 is set, the checksum loader will ignore 
all of the other switches and the monitor will ignore A15. 


24) If the load device and the terminal device are not the same, and 

the load device is not an ACR, then only the load options should 
be set before the loading. When the load completes ,the MONITOR 
will start-up and try to send a message to the load device, 
press STOP, EXAMINE loaction 5121, set the terminal option 
switches, and then depress RUN. 
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TERMINAL OPTIONS ‘ 

TERMINAL DEVICE SWITCHES UP OCTAL CHANNEL DEFAULT 


SIOA,B,C 

(NOT REV 

0) 

NONE 

0,1 


SIOA,B,C 

(REV 0) 


A14 

0,1 


( 

A9 WILL 

BE 

IGNORED FOR THIS 

BOARD ) 


88-PIO 



A13 

0,1 


4PIO 



A12 

20,21 

(INPUT) 





22,23 

(OUTPUT) 

2SIO 



All 

20,21 

(A10 UP=1ST0P BIT 


DOWN=2STOP BITS) 


If sense switch A9 is raised, interrupt I/O will not be enabled. See 
Appendix F for description of this feature. 

*************************************************************** 

CAUTION: If your I/O board is not strapped for input interrupts and 

sense switch A9 is not raised, the monitor prompt will be printed but 
terminal input will be ignored. 

*************************************************************** 

The default channels listed above may be changed as desired by raising 
A8 and storing the lowest channel number (INPUT FLAG CHANNEL) in 
location 7777 (OCTAL) . 

Note: The "INPUT FLAG CHANNEL" may also be refered to as the "CONTROL 

CHANNEL" in other Altair documentation. 

The above information is useful only when the load device and the 

terminal device are not the same. During the load procedure A8 will be 
ignored; therefore,the board from which the monitor is loaded must be 
strapped for the channels listed in the load option chart. 

25) When loading paper tape from a device connected to a SIO A,B,C 

or a 88-PIO board, start the tape reading and then depress run. 

If the device is connected to a 2SI0 or 4PI0 depress RUN and 

then start the tape reader. If you are loading from cassette, 
turn the cassette recorder to play. Wait 15 seconds and then 
depress RUN. 
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'^6) The new Checksum Loader will display 7647 on the address lights 

when running properly. When an error occurs (checksum "C"-bad 
data, memory "M"-data won't store properly, overlay "0"-attempt 
to load over top of the checksum loader) the address lights will 
then display 7637. The ASCII error code is stored in the 
accumulator (A) and is being output on channels 1, 21, and 23. 

27) When the tape finishes reading, the MONITOR should start up and 

print the normal prompt - ? .If you are loading from 

cassette, STOP the player immediately so other files can be 
loaded. 
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Appendix F. 



Audio Cassette Users 


The following table shows the order and length of files on the 
cassette of Package II. 


Program 

Name 


Time from Start of Tape 
(in seconds) 


MONITOR 
ASM 
EDT 
AM 2 
DBG 


13 - 125 
120 - 230 
240 - 310 
320 - 415 
430 - 510 


When recording a new file on a cassette, position the cassette 
after the last file. When using either the editor or assembler to dump 
out a file, start the recorder a few seconds before flipping sense 
switch 15. A gap of this type should be inserted between all files on a 
casette. 


ASCII Line Input 


The following describes the action taken for various special 
characters. 

<CR> - Ends a line. The monitor returns to the calling program 
when 'typed. It is not counted in the line length returned. A 
line feed is also written out if input is being echoed. 

<LF> - ends a line. Only a line feed is echoed. See above. 
<ESCAPE> - Ends a line. $ is echoed. See above. 

Octal 0 - Ignored 

<Control A> - rubs out complete line typed. 

<RUBOUT> - Backspaces one character for each one typed. 

<Control> z - End of file, branches to address given in control 
block. 


Interrupt I/O 


Package II now supports input interrupts from the terminal device. 
One I/O card in the Altair can be wired for input interrupts directly to 
the bus interrupt line(PINT), or to the lowest priority on the vectored 
interrupt card. If the terminal is set for interrupts, typing a 
<Control C> will stop execution of a program and return to the monitor. 
All registers are saved in the register save area as described in the 
monitor section of this manual. 
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Assembler Versions 

Two copies of the assembler are supplied in Package II. Version 1 
loads starting at location 5100Q and the symbol table starts at 12366Q. 
Version 2 loads at location 11553Q and the symbol table starts at 
17041Q. 

Running version 1 gives maximum memory for program space but does 
not allow the editor to be resident at the same time. Version 2 lets 
you load Debug or the editor between the monitor and the assembler, thus 
allowing assembly directly from the editor's buffer using the edit 
buffer read feature. When using the editor and Assembler Version 2, the 
editor must be patched to move the buffer area. The buffer area 
normally resides immediately after the editor, and if not moved, would 
destroy the assembler. See Appendix B for recommended memory layout. 


Version 1 - ASM 
Version 2 - AM2 


Absolute File Names 



2450 Alamo SE 
Albuquerque, NM 87106 




ALTAIR 8800 HACHINE/ASSEMBLY LANGUAGE PROGRAM CODING SHEET 

Program Name:_^Pade of 

P Irammer:___Date; 

-address s_ 

Program Length in Bytes ; Language:_Machine_Assembly 

Other Information; 


TAG 


MNEMONIC 


ADDRESS 


OCTAL 

CODE 


EXPLANATION 


















